strxfrm()               Copy a Specified Number of Characters

 #include   <string.h>                   Required for declarations only

 char         *strxfrm(string1,string2,n);
 char         *string1;                  Destination string
 const char   *string2;                  Source string
 size_t       n;                         Number of characters copied

        Included for ANSI compatability, strxfrm() is equivalent to
        strncpy(). strxfrm() copies the specified 'n' characters from
        'string2' to 'string1'. The terminating null character ('\0') is
        not automatically appended if 'n' is less than the length of
        'string2'. If 'n' is greater than the length of 'string2',
        'string1' is padded with null characters after the copy, up to
        the length 'n'.

       Returns:     A pointer to the copied string.

   -------------------------------- Example ---------------------------------

    The following statements copy 'n' characters of string2 to string1
    and print out the result.

           #include <string.h>
           #include <stdio.h>

           char *copy;
           char string1[50];
           char string2[25] = "reference guide";

           main()
           {
               copy = strxfrm(string1,string2,10);
               printf("%s\n",copy);
           }